The .app file contains the Version Manager command line for an application. In particular, the name and path to the application’s Response List file (.rsp) and to its executable file (.exe). The command line is a component of the shortcut created by the Client Installer.
Although the .app file typically has the same name as the application executable (CStudio.exe, CStudio.app), it can be assigned another name as long as the name matches that of the application’s icon (.ico) file.
The .app file is a text file. The command-line syntax in the .app file is:
"-r Path\AppName.rsp -p Path\Executable.exe /domain[]", Application Name
Punctuation is critical. The path and file information must be contained in quotation marks, and separated from the application name by a comma. You can include comments in the .app file. Comment lines must begin with a pound (#) sign.
| .App Parameter | Description |
|---|---|
|
-r |
Parses out the path to and name of the application’s .rsp file. |
|
Path\AppName.rsp |
The path to the application’s .rsp file, and the file’s name. The path (installation location) is defined in the .rsp file. See Response List Rsp Errors for more information. |
| -p | Parses out the path to and name of the application’s executable file. |
|
Path\Executable.exe |
The path to the application’s executable file, and the executable name. The executable can be an .exe or a known file type. For example, if you specify “Area51Report.XLS” as the executable, it will open the file using Excel. Note: The executable name cannot contain a space. The path (installation location) is defined in the RSP file. See Response List File for more information. |
|
/domain[] |
Include a domain to open the application to a specified domain. There are some CygNet applications that spawn other applications through the .app / .rsp mechanism (such as launching CygNet Console from CygNet Explorer through the Launch Console option, and launching an application via the CygNet Studio Button Tool). Adding the /domain[] token in the .app file will ensure that the launched application is running on the same (or different) domain as the currently running application. |
|
Application Name |
The name of the application as it appears in the CygNet Client Installer and is written to the Start menu. |
A sample .app file is shown below:
The .app file is not version managed. If you edit the file, users must reinstall the application using the CygNet Client Installer to get the updated parameters.
Application command-line parameters can be included in the Version Manager command line. An example is shown below (no line break).
|
“-rCygNet Vision\CVision.rsp -pCygNet Vision\CVision.exe \\MYSITE.BSS\SCREENS\MAINMENU.csf”, CygNet Vision |
The application command-line parameter is:
|
\\MYSITE.BSS\SCREENS\MAINMENU.csf |
This is a CygNet Vision parameter to open a screen stored in a BSS. In this case, it is the MainMenu.csf screen stored in the Screens group in the MYSITE.BSS.